Micron Document
๐ŸŽ–๏ธGitะฏั€ะฐ๐ŸŽ–๏ธ


Displaying Raw โ€ข View rendered โ€ข Download

docs/zh-rTW/user/widget.md bc4e9da3ad7a2a22768cbaecc75810e018bc40e2 (bc4e9da3) Text, 1.88 KB

---
title: Home Screen Widget
parent: User Guide
nav_order: 20
last_updated: 2026-06-25
description: Add the Meshtastic home screen widget to glance at your connected radio's local stats without opening the app.
aliases:
Tff7b72- widget
Tff7b72- home-screen-widget
Tc9d1d9 - local-stats-widget
Tc9d1d9---

Tc9d1d9# Home Screen Widget

On Android, Meshtastic provides a home screen **widget** that shows live local statistics from your connected radio at a glance โ€” no need to open the app.

Tc9d1d9## What It Shows

The widget displays the **connected radio's** current local stats:

Tff7b72- **Battery** โ€” the radio's battery level, or _Powered_ when running on external power
Tff7b72- **ChUtil** โ€” channel utilization (how busy the LoRa channel is, as a percentage)
Tff7b72- **AirUtil** โ€” airtime utilization (how much of the duty cycle your radio is transmitting)
Tff7b72- **Traffic** โ€” packets transmitted / received, and duplicates seen
Tff7b72- **Relays** โ€” packets relayed and relay cancellations (shown when the radio is relaying)

Tap the widget to open the app, or use its refresh control to request fresh stats.

Tff7b72> ๐Ÿ’ก **Tip:** The values reflect the radio you are currently connected to. If the app isn't connected to a radio, the widget shows the last known stats until it reconnects.

Tc9d1d9## Adding the Widget

Tff7b721. Long-press an empty area of your Android home screen.
Tff7b722. Tap **Widgets**.
Tff7b723. Find **Meshtastic** in the list and drag the **Local Stats** widget to your home screen.
Tff7b724. Resize it as needed โ€” the layout adapts to the available space.

Tff7b72> โš ๏ธ **Note:** The widget is Android-only. It is not available on the Desktop or iOS builds.

Tc9d1d9## ็›ธ้—œไธป้กŒ

Tff7b72- [Tff7b72Node Metrics](Te6edf3node-metrics) โ€” the full Signal Quality and Local Stats history inside the app
Tff7b72- [Tff7b72Connections](Te6edf3connections) โ€” connect to a radio so the widget has stats to show
Tff7b72- [Tff7b72Discovery](Te6edf3discovery) โ€” channel and airtime utilization across the mesh

---

Served by rngit 1.5.2 - Generated in 0.11s